Версии Модели
++++++++++++++

Описание
========

Версия — это конкретный выпуск нейронной модели с определёнными настройками и набором обучающих данных.
Разные версии могут отличаться точностью ответов, скоростью работы и поддержкой различных функций.
Выбор версии помогает подобрать оптимальный баланс между качеством генерации, быстротой ответа и расходом ресурсов.

Массив доступных версий для моделей можно получить по GET-запросу на эндпоинт:

``https://api.air.fail/public/тип-контента``

Не забудьте указать в заголовке авторизации API-ключ:

``Authorization: sk-...``

.. raw:: html

   <details>
   <summary>Показать код</summary>
1. Пример на Python (Библиотека requests) для типа контента - ``image``

.. code-block:: python

    import requests

    url = "https://api.air.fail/public/image"
    api_key = "<API-ключ>"
    headers = {"Authorization": api_key}
    response = requests.get(url, headers=headers)
    print(response.json())
2. Пример на Python (Библиотека httpx) для типа контента - ``image``

.. code-block:: python

    import httpx

    url = "https://api.air.fail/public/image"
    api_key = "<API-ключ>"
    headers = {"Authorization": api_key}
    response = httpx.get(url, headers=headers)
    print(response.json())

.. raw:: html

   </details>
   <br>

Пример результата выполнения GET-запроса:

.. code-block:: bash

    [
        {
            "title": "Flux Pro Ultra",
            "description": "Расширенные Flux-версии для создания наилучших вариантов ваших генераций",
            "slug": "fluxproultra",
            "blocked": false,
            "versions": [
              {
                "name": "Flux-Dev",
                "description": null,
                "slug": "flux-dev"
              },
              {
                "name": "Flux-Ultra",
                "description": null,
                "slug": "flux-1.1-pro-ultra"
              },
              {
                "name": "Flux-Pro1.1",
                "description": null,
                "slug": "flux-1.1-pro"
              }
            ],
            "inputs": [...],
            "parameters": [...],
        },
        <другие нейронные модели>
    ]

Ключи версий
=====================
При запросе информации о нейронных моделях, помимо основной информации, возвращается массив версий со
следующим набором ключей:

* ``name``: Наименование версии (Строка)

* ``description``: Описание версии (Строка)

* ``slug``: Идентификатор версии, необходимый для ее выбора при генерации (Строка)

Использование версий
=====================
В AIR API :doc:`параметр</DTO/Объект Модели>` ``version`` определяет конкретную версию нейронной модели,
которая будет применяться при генерации. Благодаря этому модель будет использовать параметры и функции выбранной версии.

Чтобы версия модели применилась, в :doc:`info</DTO/Объект Модели>` необходимо указать ключ version
и соответствующий slug, описанный выше.

Пример:

.. code-block:: bash

    {
        "content": "Большой белый мишка",
        "info": {
            "version": "flux-1.1-pro-ultra", // обязательный параметр, описанный выше
            <остальные параметры>
        }
    }

**Внимание**: не все нейронные модели имеют версии, поэтому ключ version указывать
необязательно. Проверьте наличие версий, выполнив GET-запрос, описанный в начале раздела.